HR - Employees - REST API
REST GET CompensationReview specification
This operation allows to retrieve compensation data from CIM (HR data hub containing compensation data updated into Taliris) with a pagination mechanism.
REQUEST
url: /rest/v1/hr/compensationReviewHeaders
The table below provide the details of the headers to be used when making the request.
| Header Name | Description |
|---|---|
| client_id | Client id having authorization to the endpoint(To be provided by DALI team) |
| client_secret | Client secret having authorization to the endpoint(To be provided by DALI team) |
Query Parameters
The table below provide the details of the query parameters that can be used when to query the webservice.
| Parameter Name | Mandatory | Description | Example |
|---|---|---|---|
| erpSource | Y | Erp source for which to get data | SAGE_CIV |
| lastUpdateDate | Y | Modication date using ISO 8601 date format 'YYYY-MM-DD HH:MI:SS' or 'YYYY-MM-DD' Rule: 1) If HH:MI:SS is not precised, data for whole day is returned. 2) If an inferior date with a difference greater than 12 months is received, last 12 months data will be returned from today's date. 3) If an inferior date with a difference less than or equal to 12 months is received, data from the requested date to today's date will be returned. | 2023-01-01 10:00:00 |
| page | N | The page number to be returned | 1 |
| limit | N | The number of rows to be returned per page(maximum : 500) | 100 |
RESPONSE
Here is the format of the expected response
{
"header": {
"apiName": "{name of the DALI API processing the request}",
"apiVersion": "{version of the DALI API processing the request}",
"correlationId": "{correlationId generated by DALI conveyed all along the transaction}"
},
"data": {
"payrollRespRubricList": [
{
"employeeErpId": "{Id of the employee}",
"idRoc": "{Id of the employee in ROC}",
"osmoseCode": "{company code in the ROC where employee is found}",
"periodicity": "{Frequency of the series}",
"amount": "{amount of the payment rubric}",
"topRubric": "{payroll section}",
"updateDate": "{modification date}",
"effectiveDate": "{effective date}"
}
],
"payrollRespPromList": [
{
"employeeErpId": "{Id of the employee}",
"idRoc": "{Id of the employee in ROC}",
"osmoseCode": "{company code in the ROC where employee is found}",
"effectiveDate": "{effective date}"
"promotion": "{promotion type}",
"promotionValue": "{promotion value}",
"updateDate": "{modification date}",
}
]
},
"links": {
"selfRef": "{link to the requested page}",
"firstRef": "{link to the first page}",
"previousRef": "{link to the previous page}",
"nextRef": "{link to the next page}",
"lastRef": "{link to the last page}"
},
"limit": {number of rows returned per page},
"currentPage": {current page number},
"totalPages": {total number of pages}
}MAPPING
Here are further information on each field in the response:
| Block | Field | Type | Description | Example |
|---|---|---|---|---|
| header | apiName | string | Name of the DALI API processing the request | hr-exp |
| header | apiVersion | string | Version of the DALI API processing the request | 1.0.0 |
| header | correlationId | string | Unique identifier generated by DALI conveyed all along the transaction | ab1251561-zdzdz2664-dz162262 |
| data.payrollRespRubricList | employeeErpId | string | Id of the employee in the ERP | 766666 |
| data.payrollRespRubricList | idRoc | string | Id of the employee in ROC | 821890 |
| data.payrollRespRubricList | osmoseCode | string | Company code in the ROC where employee is found | 28031 |
| data.payrollRespRubricList | periodicity | string | Frequency of the series | ANNUAL_AMOUNT |
| data.payrollRespRubricList | amount | decimal | Amount of the payment rubric | 9999.99 |
| data.payrollRespRubricList | topRubric | string | Payment section | SALB |
| data.payrollRespRubricList | updateDate | dateTime | Modification date - format 'YYYY-MM-DDTHH:MI:SS' | 2021-02-23T16:49:00 |
| data.payrollRespRubricList | effectiveDate | date | Effective date - format 'YYYY-MM-DD' | 2021-03-01 |
| data.payrollRespPromList | employeeErpId | string | Id of the employee in the ERP | 777777 |
| data.payrollRespPromList | idRoc | string | Id of the employee in ROC | 821892 |
| data.payrollRespPromList | osmoseCode | string | Company code in the ROC where employee is found | 28035 |
| data.payrollRespPromList | effectiveDate | date | Effective date - format 'YYYY-MM-DD' | 2021-03-01 |
| data.payrollRespPromList | promotion | string | Promotion type | VE_KP22_STATUS |
| data.payrollRespPromList | promotionValue | string | Promotion value | MA_CADRE |
| data.payrollRespPromList | updateDate | dateTime | Modification date - format 'YYYY-MM-DDTHH:MI:SS' | 2021-02-23T00:00:00 |
| data.links | selfRef | string | Link to the requested page | https://hr-exp.dali-latest.vinci-energies.net/rest/v1/compensationReview?erpSource=HRA&lastUpdateDate=2022-01-01%2000:00:00&limit=100&page=3 |
| data.links | firstRef | string | Link to the first page | https://hr-exp.dali-latest.vinci-energies.net/rest/v1/compensationReview?erpSource=HRA&lastUpdateDate=2022-01-01%2000:00:00&limit=100&page=1 |
| data.links | previousRef | string | Link to the previous page | https://hr-exp.dali-latest.vinci-energies.net/rest/v1/compensationReview?erpSource=HRA&lastUpdateDate=2022-01-01%2000:00:00&limit=100&page=2 |
| data.links | nextRef | string | Link to the next page | https://hr-exp.dali-latest.vinci-energies.net/rest/v1/compensationReview?erpSource=HRA&lastUpdateDate=2022-01-01%2000:00:00&limit=100&page=4 |
| data.links | lastRef | string | Link to the last page | https://hr-exp.dali-latest.vinci-energies.net/rest/v1/compensationReview?erpSource=HRA&lastUpdateDate=2022-01-01%2000:00:00&limit=100&page=10 |
| data | limit | Integer | Number of rows returned in page | 100 |
| data | currentPage | Integer | Current page number | 3 |
| data | totalPages | Integer | total number of pages | 10 |